package com.stellar.circle.basic.dao;

import com.stellar.circle.basic.entity.SPostTagMapping;
import org.apache.ibatis.annotations.Param;
import org.apache.ibatis.annotations.Update;

import java.util.List;

/**
 * 帖子话题关联表(SPostTagMapping)数据访问层
 *
 * @author Jqchan
 * @since 2025-05-17 19:30:47
 */
public interface SPostTagMappingDao {

    /**
     * 通过ID查询单条数据
     *
     * @param id 主键ID
     */
    SPostTagMapping queryById(@Param("id") Long id);

    /**
     * 条件查询单条结果
     *
     * @param condition 查询条件
     */
    SPostTagMapping queryByCondition(@Param("condition") SPostTagMapping condition);

    /**
     * 条件查询所有结果
     *
     * @param condition 查询条件
     */
    List<SPostTagMapping> queryAllByCondition(@Param("condition") SPostTagMapping condition);

    /**
     * 分页查询
     *
     * @param condition 查询条件
     * @param page      页码
     * @param pageSize  每页数量
     */
    List<SPostTagMapping> page(@Param("condition") SPostTagMapping condition,
                               @Param("page") int page,
                               @Param("pageSize") int pageSize);

    /**
     * 条件统计
     *
     * @param condition 统计条件
     */
    Long count(@Param("condition") SPostTagMapping condition);

    /**
     * 新增数据
     *
     * @param entity 实例对象
     */
    int insert(@Param("entity") SPostTagMapping entity);

    /**
     * 批量新增
     *
     * @param entities 实例列表
     */
    int insertBatch(@Param("entities") List<SPostTagMapping> entities);

    /**
     * 更新数据
     *
     * @param entity 实例对象
     */
    int update(@Param("entity") SPostTagMapping entity);

    /**
     * 通过主键删除
     *
     * @param id 主键ID
     */
    int deleteById(@Param("id") Long id);

    /**
     * 通过帖子ID删除
     *
     * @param postId
     */
    @Update("update s_post_tag_mapping set is_deleted = 1 where post_id = #{postId}")
    void deleteByPostId(Long postId);

    /**
     * 通过学校ID统计话题数量
     *
     * @param schoolId
     * @return
     */
    Long countBySchool(Long schoolId);

    /**
     * 通过学校ID分页查询
     *
     * @param schoolId
     * @param start
     * @param pageSize
     * @return
     */
    List<SPostTagMapping> pageBySchoolId(@Param("schoolId") Long schoolId,
                                         @Param("start") Integer start,
                                         @Param("pageSize") Integer pageSize);
}

